home *** CD-ROM | disk | FTP | other *** search
/ The Fatted Calf / The Fatted Calf.iso / Applications / Developer / StopWatch / Source / README < prev    next >
Encoding:
Text File  |  1994-02-13  |  13.0 KB  |  308 lines
  1.             Bug Fixes for 2.5 (2/13/94)
  2.             ---------------------------
  3. * Made the ClientView form scrollable so you can see long client
  4.   names, etc.
  5. * Changed Cmd-k (compact sessions) and Cmd-D (delete all) so that they
  6.   don't expose the inspector.
  7. * Fixed HideOnAutoLaunch preference
  8.  
  9.             New Features for 2.5 (2/13/94)
  10.             ------------------------------
  11. * Added "Windows" submenu so Cmd-w closes the inspector window.
  12. * Consultant information is now stored in the defaults database and
  13.   can be inserted into the various templates. The valid keywords are:
  14.   [myName], [myCompany], [myStreet], [myCity], [myState], [myZip],
  15.   [myPhone], [myFax], and [myEmail]. These values can be edited using
  16.   the Preferences panel.
  17. * The last selected client is now remembered in the defaults db
  18.   and that client is selected again at startup.
  19. * Session durations are now displayed in hh:mm format, instead of just
  20.   showing elapsed minutes.
  21. * Added a "ShowEndTimes" preference setting, which will optionally show
  22.   the end times for each session.
  23. * Added column headings to the Expenses and Sessions browsers
  24. * All dollar amounts in inspectors and generated files now sport commas
  25.   in the appropriate places. (Of course for the Europeans, this should
  26.   be decimal points, but we'll get to that later...)
  27.  
  28.             Bug Fixes for 2.3 (7/23/93)
  29.             ---------------------------
  30. * This version was the first one posted to the archives.
  31.  
  32. * Fixed bug that caused preferences panel "reset defaults" to dump.
  33.  
  34.             New Features for 2.2 (6/23/93)
  35.             ------------------------------
  36. * Added alert panel confirmation for client deletion.
  37.  
  38. * A backup file is now created before writing changes to the data.
  39.   (The file is called client.data~)
  40.  
  41. * After an add/modify/undelete the edited cell is selected
  42.  
  43. * After deleting sessions/expenses, the first item is selected
  44.  
  45. * Two new command keys:  Cmd-+ executes the "Add" feature, and
  46.   Cmd-m executes the "Modify" button. These allow clients to be
  47.   edited without using the mouse.
  48.  
  49.  
  50.                 BUG FIXES
  51.                 ---------
  52. * After add/modify of sessions or expenses main window became key.
  53.  
  54. * If you resized the inspector with the Client Data view selected,
  55.   things got wierd.
  56.  
  57. * When the client view was first selected it sometimes didn't show the
  58.   data for the currently highlighted item.
  59.  
  60. * Fixed the appearance of a rounding error. Actually, the computation was
  61.   correct; the number of hours being displayed to 2 decimal places was
  62.   the incorrect value! The calculation now uses the some rounded value
  63.   that is displayed, so it looks like there is no discrepency.
  64.  
  65.  
  66.             New Features for 2.1 (6/15/93)
  67.             ------------------------------
  68. * The inspector view for sessions can also be invoked with Cmd-1, the
  69. expenses with Cmd-2 and the Client info with Cmd-3. (Cmd-1 was
  70. previously assigned to start/stop the stopwatch. This has been
  71. reassigned to the key Cmd-$ for obvious reasons.
  72.  
  73. * The menu item that brought up the inspector in it's current state
  74. (Cmd-i) has been removed, since the Cmd-{1,2,3} items give more
  75. immediate control.
  76.  
  77.                 BUG FIXES
  78.                 ---------
  79. * Session compaction was assigning the latest time to a group of
  80. compacted sessions, due to the newly inverted ordering of sessions.
  81. This has been restored to work the old way, i.e. the compacted session
  82. takes the time of the earliest session.
  83.  
  84. * Fixed a minor bug in which it was possible to "Add" sessions or
  85. expenses when no client was selected, which was a no-op, but possibly
  86. annoying.
  87.  
  88.             New Features for 2.0 (5/31/93)
  89.             ------------------------------
  90. * There is a new combined Client/Session/Expense inspector which
  91. replaces the previous separate Client Editor and Client Browser
  92. panels.
  93.  
  94. * The inspector can be invoked by either Cmd-i or by double clicking on
  95. an entry in the main window's browser.  The browser initially displays
  96. data for the client currently selected in the main window.
  97.  
  98. * The inspector now sports a columnized display of session
  99. and expense info. The sessions and expenses are now sorted in reverse
  100. chronological order for display.
  101.  
  102. * Session editor and expense editor now require dates in mm/dd/yy
  103. format, and time in hh:mm. This is to provide a consistently parsable
  104. format for sorting by time and date.
  105.  
  106. * When entering sessions using the session editor, the session
  107. duration can now be given in any of three formats: "hh:mm" (1:45 means
  108. 1 hour and 45 minutes), or "h.d" (1.5 means one and one half hours),
  109. or an un-punctuated number "m" (22 means 22 minutes.)
  110.  
  111. * Expense totals (for client and across all clients) are displayed in
  112. the inspector's expense view.
  113.  
  114. * When manually adding a new item, the Expense and Session editors are
  115. initialize to show the current date and time.
  116.  
  117. * Selection of multiple session or expenses is now allowed, and the
  118. "Select All" menu item does the right thing. (The only operation
  119. allowed on multiple selections of sessions or expenses is deletion.)
  120.  
  121. * Clients, sessions and expenses can be undeleted. Each deletion is
  122. saved on a list particular to that type of object. Undeleting pops the
  123. last item from the list.
  124.  
  125. * The import/export delimiter has been changed to a tab '\t' and it's
  126. definition has been centralized in Controller.h, in case you want to
  127. change it. If the need is there, this can become a preference item.
  128. This was requested to allow the data to be used directly in some
  129. spreadsheet products.
  130.  
  131. * Generated files now have the "most likely" current month added to
  132. their names for convenient reference. The heuristic for "most likely"
  133. is: the prior month if the current day is < 20, otherwise the current
  134. month.  This assumes you generate your invoice for each month between
  135. the 20th of that month and the 20th of the next month.
  136.  
  137. * The manual has been updated to reflect these (most of) changes, and 
  138.   has been transformed into a 3.0 Help document. Use Info->Help.
  139.  
  140. * Major code restructuring and cleanup.
  141.  
  142.  
  143.                 Bug Fixes
  144.                 ---------
  145. * If you deleted all and don't make any changes, file was never written!
  146.  
  147.  
  148.  
  149.             New Features for 1.7
  150.             --------------------
  151. * Windows remember their size and placement
  152. * Stop/Start menu item (Cmd-1)
  153. * Menu items to load templates into Edit
  154. * Fixed a bug which caused the the templates from the app wrapper to be used
  155.   even though it copied the templates to the ~/Library/Stopwatch/Templates
  156.   directory! They were never subsequently used. (Oops!)
  157. * a "HideOnAutoLaunch" preference item
  158. * Wider text fields in Session browser to display current totals. Thankfully, this was
  159.   required.
  160.  
  161.             New Features for 1.6
  162.             ---------------------
  163. * A manual!  See Manual.rtfd.
  164. * Copying of templates files now implemented directly rather than exec'ing
  165.   /bin/cp.
  166. * Fixed the main menu's "New Client" button, which got disconnected somehow.
  167. * The addition and deletion of clients is now reflected in the client
  168.   browser and the main window.
  169. * Translation of tokens now implemented directly instead of requiring perl.
  170. * Token format changed to square-bracketed strings for easier parsing. See
  171.   Manual.rtfd for all available keywords. 
  172.  
  173.             New Features for 1.51
  174.             ---------------------
  175. * Added new keywords #rate and #hours for use in the invoice template.
  176. * Changed "File->Export" to use the client's short name rather than the
  177.   full name.
  178. * Removed support for importing archaic log format.
  179. * Fixed bug where if you double clicked in the Client Editor's browser
  180.   you would crash the app.
  181. * Removed random .tiff artifacts from the directory.
  182.  
  183.             New Features for 1.5
  184.             --------------------
  185. * Added a preferences panel with two data items: the directory in which to
  186.   generate invoice files, and the next invoice number to use.  These values
  187.   are stored in the defaults database with the following defaults:
  188.     Stopwatch InvoiceNum 0
  189.     Stopwatch InvoiceDir /tmp
  190. * The invoice number read from the defaults db is incremented by the invoice
  191.   generation process, and the db is updated as well. This number is also now
  192.   incorporated into the generated filenames so that each invoice file is 
  193.   unique. (Earlier you had to rename them to keep them around since the names 
  194.   were the same each month for the same client.)
  195. * Added expense report generation.
  196. * Invoices, invoice detail, and expense reports are now RTF-based. They use
  197.   template files which contain certain key words (prefixed by '#') which are
  198.   replaced with values from the client data.  If the template files are not
  199.   found in ~/Library/Stopwatch/Templates, they are copied there from the app
  200.   wrapper. Storing them externally to the app protects user mods from app
  201.   updates. Modify these files to customize your reports.
  202. * Also note, the RTF file generation is based on perl scripts included in the
  203.   app wrapper. YOU NEED PERL TO USE THIS FEATURE! (see *.perl)  Also note that
  204.   these scripts are hardwired to expect perl in /usr/local/bin/perl. This can
  205.   be changed but I didn't bother...
  206. * Expense reports are based on "ExpensesTemplate.rtf". Invoice detail uses the
  207.   template file "DetailTemplate.rtf". The main invoice uses "InvoiceTemplate.rtf".
  208.   All available keywords are used in the example templates, but you don't have
  209.   to use them all in your customized versions.
  210. * Changed "Sessions->Delete All" command to also delete all expenses records
  211.   for all clients.
  212.  
  213.             New Features for 1.42
  214.             ---------------------
  215. * Changed font to bold when running so you can see if the clock is ticking
  216. * Added powerOf:in:andSave: so you don't loose your work of you logout or power off.
  217.  
  218.             New Features for 1.4
  219.             --------------------
  220. * Reshaped Main Window, changed resizing behavior. The client list can be     
  221.     reduced to nothing. (done earlier but never logged)
  222. * New Icon
  223. * Added AppIconView class for displaying time in the application icon.
  224. * made changes to Controller to make this happen.
  225. --hjk
  226.  
  227.             New Features for 1.3
  228.             --------------------
  229. * Further reduced the size of the main window, and eliminated the unsightly radio
  230.   buttons within the scroller.  Reduced the size of the text on labels and text
  231.   fields as well.
  232.  
  233. * Prior versions had a bug in which, if a session is active and you clicked on
  234.   another client in the main window, the new session got credited to the newly
  235.   clicked client, rather than the original one!  This has been fixed.
  236.  
  237. * Added ExpenseEditor support so expenses for a client can be entered and edited.
  238.   Still must add support for detail reporting on these expenses...
  239.  
  240.             New Features for 1.2
  241.             --------------------
  242. * Client panel now supports a 'short name' for each client.  This serves two purposes:
  243.     - the main window has been made somewhat smaller
  244.     - the generated file have much more managable names, e.g. nacm_dtl.framemif
  245.  
  246. * The program recognizes old version archives (version == 0) and
  247.   initializes the short name field to the full client name.  You should
  248.   run the new version and edit all short names as desired.  This will
  249.   cause a version 1 file to be written containing the short name.
  250.  
  251. * Invoice files are no longer generated for clients for whom no work was performed.
  252.  
  253. * A couple of diagnostic messages which were printed during invoice
  254.   generation have been deleted from the code.
  255.  
  256.  
  257.                 New Features for 1.1
  258.                 --------------------
  259.  
  260. * Two new menu items were added: "File/Save As..." and "Delete All
  261. Sessions...". The "Save As..." was added to allow the easy creation of
  262. an archive of the current month's data, in preparation for using the
  263. "Delete All Sessions..." feature.  This clears out all session
  264. information and resets all time and billing variables to 0, allowing a
  265. new month to be started fresh.
  266.  
  267. (Ultimately, the tool should sit on a database such as dbVista,
  268. allowing much more extensive reporting and archiving capabilities...)
  269.  
  270. * Two new output fields were added to the Session Browser, showing the
  271. dollar amount billable for the selected client as well as the
  272. total for the month across all clients.
  273.  
  274.                 New Features for 1.0
  275.                 --------------------
  276.  
  277. * Client descriptions and work session data stored in a single
  278. typestream which is manipulated by a series of data entry panels and
  279. browsers.
  280.  
  281. * Generates frame maker invoice detail documents automatically. (For now,
  282. these get deposited in the ~/Library/Stopwatch directory, just because it
  283. was easy.)
  284.  
  285. * The main window looks much as it did before. Instead of writing
  286. lines of text to an ascii file, it adds elements to a data structure
  287. which is automatically written to a typestream file whenever there are
  288. changes.
  289.  
  290. * Task description string defaults to the last string entered for each
  291. individual client.  (This works well with the "Compact" command
  292. described below.)
  293.  
  294. * Client Setup allows client data to be entered. Some of this is used
  295. to generate the invoice detail document. (This feature is still under
  296. construction but is already worth using. Some touch up is required on the
  297. generated document however, such as invoice #.)
  298.  
  299. * Session Browser allows manual entry and modification of individual
  300. sessions. Also shows total hours across all clients, and subtotals for
  301. individual clients, which are all updated upon each new entry or edit.
  302. Entries created via the main window start/stop controls are added to
  303. the browser automatically.
  304.  
  305. * Primitive import/export facility to handle ascii files (see more below)
  306. This can also be useful if you don't want to generate frame maker files.
  307.  
  308.